3.3 联系人

i . 同步

同步联系人需要使用到天琴内置的联系人实体，实体含有一簇常用的构造方法，请根据实际场景按需调用：

实体：com.aispeech.integrate.contract.phone.ContactsInfo;

联系人数据构造方式, 标准如下(请勿使用其它方式)：

方案一, 联系人单号
// 联系人名称(必填), 电话号码(必填).
ContactsInfo(String originalName, String number);

方案二, 联系人多号(单号也可使用此方案)
// 以下展示参数为必填, 选填可自行查看javaBean
ContactsInfo contactsB = ContactsInfo(String originalName, String number_1);
PhoneInfo phone_1 = new PhoneInfo(); //构造号码 1
phone_1.setNumber(number_1);
contactsB.addPhoneInfo(phone_1); // >>> 添加号码 1
PhoneInfo phone_2 = new PhoneInfo(); //构造号码 2
phone_2.setNumber(number_2);
contactsB.addPhoneInfo(phone_2); // >>> 添加号码 2
// 或者将phone_1 & phone_2 添加进list内, 调用: contactsB.addPhoneInfos(List<PhoneInfo>);

将联系人数据组装好之后，调用AiLit Api同步（覆盖式）给天琴即可：

AiLitContext.getPhoneManager().syncContacts(List<ContactsInfo> );

Tips：天琴不会主动询问联系人数据

ii . 更新状态

天琴内置了“蓝牙连接中”、“通讯录同步中”两种状态，如对默认的状态不满意可以调用以下接口，以校准状态：

AiLitContext.getPhoneManager().updateSyncState(ContactsInfo.SYNC_SYNCING);

在同步联系人失败时，需更新同步失败状态给天琴：

AiLitContext.getPhoneManager().updateSyncState(ContactsInfo.SYNC_FAILED);

Tips：当联系人同步成功后，不需要通过上述接口改变状态，天琴会主动将同步状态置为成功。

iii. 清空

当需要时，可主动清空天琴中存储的联系人数据，按需调用：

AiLitContext.getPhoneManager().clearContacts();